Skip to main content

Get User Posts By Day

GET /:username/posts/:date​

Description​

Returns a paginated list of a user's posts for a specific day.

The date route param expects DD-MM-YYYY. If it is invalid, the API falls back to the viewer's current day.

Request Parameters​

Requires Authentication: true​

PATH PARAMS​

NameTypeRequiredDescription
usernamestringYesTarget username.
datestringYesDay in DD-MM-YYYY format.

QUERY PARAMS​

NameTypeRequiredDescription
pagenumberNoPage number. Defaults to 1.
maxPageSizenumberNoPage size. The API caps it at the shared max page size.
orderstringNoOptional sort mode. Defaults to relevant.

Usage Example​

await axios.get(
"https://api.daykeeper.app/johndoe/posts/18-03-2026?page=1",
{
headers: {
Authorization: `Bearer ${accessToken}`,
},
}
)

Success Response​

{
"message": "posts fetched successfully",
"data": [
{
"_id": "67d9c0d4cc9e4db02fca1001",
"description": "A post from that day"
}
],
"page": 1,
"pages": 1
}

Error Response​

CodeDescription
401Missing or invalid access token
404User not found
500Server error